Skip to content

fix(blog): replace retired self-host upgrade URL with /docs/self-host - #19821

Merged
ivanagas merged 1 commit into
masterfrom
posthog-self-driving/fixblog-replace-stale-self-host-upgrade-a87c00
Aug 31, 2026
Merged

fix(blog): replace retired self-host upgrade URL with /docs/self-host#19821
ivanagas merged 1 commit into
masterfrom
posthog-self-driving/fixblog-replace-stale-self-host-upgrade-a87c00

Conversation

@posthog

@posthog posthog Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Changes

Problem

  • Blog posts link to /docs/runbook/upgrading-posthog, a retired route that now redirects to /docs/self-host.
  • A reader who navigates directly recovers through the redirect, but Gatsby prefetches the old path's page-data and gets a 404 — a failed first-party request every time such a link enters the viewport.
  • An inbox report measured repeatable prefetch 404s from first-party referrers over 7 days.

Fix

  • Replace the link target with /docs/self-host across all blog posts (44 files).
  • The report named 5 posts (the ones with measured traffic), but the same stale link sits in ~44 posts — the same root cause. Fixing only the 5 leaves the rest to produce the identical 404 as they get traffic, so this change covers the whole class.
  • The vercel.json redirect stays in place for external bookmarks.

Out of scope

  • A few contents/docs/ pages also link to the old path (self-host/index.mdx, migrate/migrate-to-cloud.mdx, js-snippets/pineapple-mode.md). They are a different context from the reported blog symptom and are left for a separate change.

Checklist

  • I've read the docs and/or content style guides.
  • Words are spelled using American English
  • Use relative URLs for internal links
  • I've checked the pages added or changed in the Vercel preview build
  • If I moved a page, I added a redirect in vercel.json

Created with PostHog Desktop from this inbox report.

@posthog
fix(blog): replace retired self-host upgrade URL with /docs/self-host
fca78d6 
The blog posts link to /docs/runbook/upgrading-posthog. That route now
redirects to /docs/self-host. Direct navigation still works, but the
Gatsby page-data prefetch for the old path returns 404, so every reader
who hovers such a link makes a failed first-party request.

Replace the link target with /docs/self-host across all blog posts. The
redirect stays in place for external bookmarks.

Generated-By: PostHog Desktop
Task-Id: d33c5d00-8e0f-4ed4-9c8b-7375970e01f8
@posthog

posthog Bot commented Aug 29, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor Author

🦔 PostHog Review reviewed this pull request

Nothing worth raising this time, so here's a calming picture instead:

Someone relaxing in a sunny garden

@github-actions github-actions Bot added the content PR only touches files under contents/ label Aug 29, 2026
@github-actions

github-actions Bot commented Aug 29, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Aug 29, 2026 08:23PM

@github-actions

github-actions Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Vale prose linter → found 130 errors, 1941 warnings, 35 suggestions in your markdown

Full report → · Copy the Job Summary code block into an LLM to batch-fix issues.

Note: Too many findings to show inline. See the Job Summary linked above.

File Errors Warnings Suggestions
contents/blog/the-posthog-array-1-0-10.md 0 10 0
contents/blog/the-posthog-array-1-0-11.md 0 18 2
contents/blog/the-posthog-array-1-0-8.mdx 0 10 1
contents/blog/the-posthog-array-1-0-9.md 0 8 1
contents/blog/the-posthog-array-1-1-0.md 1 22 0
contents/blog/the-posthog-array-1-10-0.md 11 15 1
contents/blog/the-posthog-array-1-11-0.md 3 7 0
contents/blog/the-posthog-array-1-12-0.md 2 15 0
contents/blog/the-posthog-array-1-13-0.md 7 14 4
contents/blog/the-posthog-array-1-14-0.md 0 21 1
contents/blog/the-posthog-array-1-16-0.md 0 92 2
contents/blog/the-posthog-array-1-17-0.md 2 131 0
contents/blog/the-posthog-array-1-18-0.md 1 143 0
contents/blog/the-posthog-array-1-19-0.md 0 149 2
contents/blog/the-posthog-array-1-2-0.md 1 8 1
contents/blog/the-posthog-array-1-20-0.md 3 141 3
contents/blog/the-posthog-array-1-21-0.mdx 3 287 2
contents/blog/the-posthog-array-1-22-0.mdx 2 160 2
contents/blog/the-posthog-array-1-23-0.mdx 3 94 0
contents/blog/the-posthog-array-1-24-0.mdx 4 236 1
contents/blog/the-posthog-array-1-25-0.mdx 3 30 4
contents/blog/the-posthog-array-1-26-0.md 1 45 1
contents/blog/the-posthog-array-1-27-0.md 0 28 2
contents/blog/the-posthog-array-1-28-0.md 0 17 1
contents/blog/the-posthog-array-1-29-0.md 8 26 0
contents/blog/the-posthog-array-1-3-0.md 1 15 1
contents/blog/the-posthog-array-1-30-0.md 1 16 0
contents/blog/the-posthog-array-1-31-0.md 1 14 0
contents/blog/the-posthog-array-1-32-0.md 3 8 0
contents/blog/the-posthog-array-1-33-0.md 2 11 0
contents/blog/the-posthog-array-1-34-0.md 9 9 0
contents/blog/the-posthog-array-1-35-0.md 4 11 0
contents/blog/the-posthog-array-1-36-0.mdx 5 12 0
contents/blog/the-posthog-array-1-37-0.mdx 3 7 0
contents/blog/the-posthog-array-1-38-0.mdx 2 18 0
contents/blog/the-posthog-array-1-39-0.mdx 3 20 1
contents/blog/the-posthog-array-1-40-0.md 1 8 0
contents/blog/the-posthog-array-1-41-0.md 4 12 0
contents/blog/the-posthog-array-1-43-0.md 2 8 0
contents/blog/the-posthog-array-1-5-0.md 0 8 0
contents/blog/the-posthog-array-1-6-0.md 3 5 2
contents/blog/the-posthog-array-1-7-0.md 9 10 0
contents/blog/the-posthog-array-1-8-0.md 6 7 0
contents/blog/the-posthog-array-1-9-0.md 16 15 0

@github-actions

github-actions Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

8.15 MiB (no change)

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint Eager size Budget Modules
✅ app 16.91 MiB (no change) report-only 2036
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 1053.9 KiB
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css 754.5 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js 481.4 KiB
./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules 395.1 KiB
./src/hooks/useCustomers.tsx + 55 modules 370.0 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js 354.8 KiB
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules 351.4 KiB
./src/components/ProductComparisonTable/index.tsx + 126 modules 301.7 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 KiB
./src/components/SearchUI/index.tsx + 87 modules 273.0 KiB
./node_modules/.pnpm/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/magnifying-glass.mjs 254.7 KiB
./node_modules/.pnpm/framer-motion@10.18.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/dom/motion.mjs + 109 modules 253.9 KiB
./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules 247.4 KiB
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules 240.1 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

@posthog
posthog Bot marked this pull request as ready for review August 29, 2026 20:26
@posthog
posthog Bot requested a review from a team August 29, 2026 20:26
@ivanagas
ivanagas merged commit 0a87574 into master Aug 31, 2026
22 checks passed
@ivanagas
ivanagas deleted the posthog-self-driving/fixblog-replace-stale-self-host-upgrade-a87c00 branch August 31, 2026 08:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@ivanagas ivanagas ivanagas approved these changes

Assignees

No one assigned

Labels

content PR only touches files under contents/

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@ivanagas